home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr49 / 115_01.zip / INSTALL.DOC < prev    next >
Text File  |  1993-06-01  |  8KB  |  244 lines
  1. .cm screen editor:  installation guide
  2. .cm Source:  install.doc
  3. .cm
  4. .he 'install.doc''September 6, 1981'
  5. .fo ''-#-''
  6.  
  7.    This document tells you how to get the
  8. screen editor up and running on your system.
  9. To do this you need the following:
  10.  
  11. .nf
  12. 1.  A CP/M version 1.4 or 2.2 operation system which
  13.     runs on an 8080, Z-80 or 8085 based computer.
  14.  
  15. 2.  An 8 inch single density floppy disk drive.
  16.  
  17. 3.  At least 48K of central memory.
  18.  
  19. 4.  A video display which has a goto x,y cursor
  20.     positioning function.
  21. .br
  22. .fi
  23.  
  24.    To get the screen editor up and running on your
  25. system all you need to do is follow these 6 steps.
  26.  
  27. .ul
  28. Step 1:  Back up the diskette.
  29.  
  30.    Make a backup copy of your diskette.
  31. Do it now.
  32.  
  33. .ul
  34. Step 2:  Run the configuration program
  35.  
  36.    Start the configuration program by typing 'config'
  37. from CP/M.
  38.  
  39.    The configuration program tailors the screen editor for
  40. your particular keyboard and display screen.
  41. The configuration program asks you three sets of questions.
  42. After you finish answering all the questions the configuration
  43. progrm creates two files which describe your keyboard
  44. and video display.
  45. These two files are included into the screen editor during
  46. step 3.
  47.  
  48.    The first set of questions ask you what keyboard
  49. keys you want to use for each special function that
  50. the editor uses.
  51. To answer each question you may type either a decimal
  52. number or a carriage return.
  53.  
  54.    If you type a carriage return the configuration
  55. program will use the default key.
  56. The configuration program will tell you what the
  57. default value is for each key.
  58. I recommend that you use the default value
  59. unless your keyboard does not have the default key.
  60.  
  61.    If you type a decimal number instead of a carriage
  62. return then you are indicating that you wish to
  63. use the key whose ascii code is the same as that
  64. decimal number.
  65. For example, suppose the configuration program
  66. asks you for the value of the left key.
  67. If you type (say) 11 as a response this means
  68. that the control-k key will be used as the left key.
  69.  
  70.    Note that the values you enter should either
  71. be less than 32 or be equal to 127.
  72. Avoid values greater than 127 or less than 0.
  73.  
  74.    After you answer all these questions you
  75. will be asked if all the answers are correct.
  76. If you say no, then you will be asked the same
  77. questions over again.
  78.  
  79.    Note that you can always use the normal
  80. CP/M line editing functions if you make
  81. a mistake in typing a line.
  82. Also, you can leave the configuration program
  83. by hitting control-c any time that the program
  84. asks for input from you.
  85.  
  86.    The next set of questions asks what special
  87. built-in functions your display screen has.
  88. Answer each question with a yes or a no.
  89. You may use the letters 'y' or 'n' for yes or no.
  90.  
  91.    Again, after finishing the questions you will
  92. be asked if you are satisfied with your answers.
  93. If not, type 'no' and you will be given another chance.
  94.  
  95.    The third and last set of questions asks you
  96. to supply the actual characters that you must
  97. output to your display screen to get the screen
  98. to do the special functions you said it had.
  99. For each special functions, you will be asked to
  100. enter those bytes one at a time.
  101.  
  102.    For example, let us start with the goto x,y
  103. special function.
  104. This is the only special function that your
  105. display MUST have in order to use the screen editor.
  106. Now suppose that in order to move the cursor to
  107. ROW y and COLUMN x you must output the escape
  108. character (27) followed by an equal sign, followed
  109. by the 32 plus x, followed by 32 plus y.
  110. To do this you would type the following:
  111.  
  112. .nf
  113. Enter byte 1:  27
  114. Enter byte 2:  '='
  115. Enter byte 3:  x+32
  116. Enter byte 4:  y+32
  117. Enter byte 5:  (return)
  118. .br
  119. .fi
  120.  
  121.    Note that you type a carriage return to stop entering
  122. bytes.
  123.  
  124.    Be
  125. .ul
  126. sure
  127. that you enter the row and column numbers in the order that
  128. your terminal expects.
  129. (Many terminals use a sequence in which the row and column
  130. numbers are reversed from the sequence shown above).
  131.  
  132.    If you do make a mistake in the goto xy sequence
  133. then the screen will not look at
  134. all like it should
  135. when you run the editor in step 6.
  136.  
  137.    When you have finished with this last section
  138. you will be asked whether you are ready to
  139. create two files.
  140. If you say yes and the configuration program will
  141. erase the two files if they already exist,
  142. create the two files, and then exit.
  143. If you say no the configuration program will exit without
  144. doing anything.
  145. Say yes unless you don't want to erase existing versions
  146. of the two files.
  147.  
  148. .ul
  149. Step 3:  Compile the editor
  150.  
  151.    Next, compile the editor using the
  152. small-C compiler on file c80.com.
  153. Start the compiler by typing 'c80' from CP/M.
  154.  
  155.    The compiler will sign on and ask you three
  156. questions.
  157. Answer each one by typing a carriage return.
  158. Next, the compiler will ask for an output file.
  159. Type 'ed.asm' as the answer or 'b:ed.asm' if you
  160. don't have about 150k bytes free on drive a.
  161. Note that the compiler produces a large output file.
  162. Next the compiler will ask for an input file.
  163. Type 'ed.c' as the answer.
  164.  
  165.    The compiler will now run for ten to twenty minutes.
  166. When the compiler is finished it will ask for
  167. another file.
  168. Type carriage return and the compiler will finish.
  169. There should be 0 errors.
  170.  
  171.    If you did get an error you may have made a mistake
  172. when you typed in the sequences of bytes for the
  173. configuration program.
  174. Such an error will show up when the compiler is compiling
  175. the file ed6.ccc.
  176. If there is an error on file ed6.ccc you must redo step 2.
  177.  
  178.    Something is wrong with the files on your
  179. disk if you got any other error.
  180. No error you can make using the configuration
  181. program should cause an error which shows up in any
  182. file except ed6.ccc.
  183. Get a fresh copy of the disk from your backup
  184. diskette and start over again from step 2.
  185.  
  186. .ul
  187. Step 4:  Assemble the editor
  188.  
  189.    Assuming all has gone well so far, you are
  190. now ready to assemble the screen editor using
  191. the CP/M editor on file asm.com.
  192. Type 'asm ed.aaz' from CP/M.
  193. (Type 'asm ed.baz' if ed.asm is on drive b).
  194. The output from the editor will be on file ed.hex.
  195.  
  196.    Again, there should be no errors.
  197. If there are you will have to start all over again.
  198. Most probably something is wrong with your disk.
  199.  
  200. .ul
  201. Step 5:  Load the editor
  202.  
  203.    Create a .com file for the editor by
  204. typing 'load ed'.
  205. This will create the file ed.com.
  206. This will also wipe out the CP/M ED editor if it is on
  207. drive a.
  208. One way to save the CP/M ED editor would be to rename
  209. it before typing 'load ed'.
  210.  
  211. .ul
  212. Step 6:  Test and use the editor
  213.  
  214.    You are now ready to use the editor.
  215. Invoke the editor by typing 'ed' from CP/M.
  216. It should clear the screen, draw the prompt line at the
  217. top of the screen and tell you what version you are using.
  218.  
  219.    If that doesn't happen you probably gave the configuration
  220. program the wrong information about the goto x,y cursor
  221. function.
  222. When you specify the goto xy function remember:
  223. x means the COLUMN number, y means the ROW number.
  224. Make
  225. .ul
  226. sure
  227. you have specified the row and column numbers in the order your
  228. terminal expects.
  229. Take a deep breath and repeat steps two through six.
  230.  
  231.    If the screen looks reasonable, try out all the commands
  232. from the user guide.
  233. Be sure to check whether the hardware screen scrolling
  234. is working properly.
  235.  
  236.    Note that the configuration program can not handle keyboard
  237. keys that produce more than one character.
  238. If you want to use such keys you will have to modify the file
  239. ed2.c.
  240. Then, of course, you will have to compile, assemble, and load
  241. the new editor.
  242. I recommend that you get the editor working before you attempt
  243. to modify it.
  244.